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1. SCOPE 


The recent proliferation of Yield Estimation Sxibsystem (YES) 
yield models (and their associated data files) dictated the 
immediate need for a specialized data management system to 
adequately support the data requirements of the operational YES. 
This document provides the detailed system design specification 
of the YES Data Management System (YESDAMS) prior to the commence- 
ment of system coding, debugging, and program integration. YESDAMS 
provides for the basic functions of definition, replacement, 
addition, deletion, and listing of all data on the YES files. 

Backup and recovery procedures will be addressed under separate 
cover. 
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2. APPLICABLE DOCUMENTS 


AD 63“I347-4963-18 YES Data Management System 


3 . SYSTEM DESCRIPTION 


The Yield Estimation Subsystem Data Management System (YESDAMS) 
is a specialized data management system designed to solve the 
specific data handling problems of the YES. While the basic 
functions of definition, replacement, addition, deletion, and 
listing are common to most data management systems, these 
functions are designed to address the lonique requirements of the 
YES. Consequently, no attempt has been made to extend any of 
the functions to the more generalized data management problem. 
While this somewhat reduces the flexibility of the system, it is 
felt that the gains in reduced program size and execution time 
and ease of use far outweigh the loss of flexibility. 

Every attempt has been rade to follow the basic tenets of top- 
dovm, structured programming using HlPO (Hierarchical Input 
Processing Output) techniques. The design consists of a main 
program which initiates a calling sequence several levels deep 
in order to process input requests . Input transactions are in 
the form of cards, but the concepts could easily be extended to 
encompass interactive, time-sharing techniques. 

3.1 HARDWARE DESCRIPTION 

The programs and associated data files will be resident on the 
IBM 360/195 complex at Suitland, Maryland. They should be 
transferable ho any IBM 360-370 series computer with sufficient 
disk space to handle the data files and main memory to. support 
the Pl/I optimizing compiler. 

3.2 SOFTWARE DESCRIPTION 

The software design consists of a main program and several levels 
of subprograms (or subroutines) , which are called to process the 
individual input requests. The input requests are interpreted 
(parsed) at each level in order to determine the subsequent sub- 
routine to be called or action to be taken. 
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Figure 3.O.- Level 1 and I 
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3.2.1 PROGRAM MAIN 

MAIN reads the input cards and determines which one of the level 1 
subroutines is to be called. The level 1 subroutines and their 
functions are: 


ID 

Name 

Function 

R1 

DEF 

Define 

R2 

RPL 

Replace 

R3 

ADD 

Add 

R4 

DEL 

Delete 

R5 

LST 

List 


3. 2. 1.1 Linkages 

MAIN calls subroutines DBF, RPL, ADD, DEL, and LST. 

3. 2. 1.2 Interfaces 

MAIN provides the interface between the input request and the 
proper interpretive subroutine. 

3.2 .1. 3 Inputs 

The input to MAIN is an action request in card format. 

3. 2. 1.4 Outputs 

The output from MAIN is a partially parsed action request which 
is passed to the proper level 1 subroutine for further action and/ 
or an error message which is passed to the system for display. 

3 . 2 . 1 . 5 Description 

MAIN reads the input action request cards one at a time and 
decides, by examining the first three characters of the request, 
which function is being requested. In the case of an error being 
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generated somewhere during processing, MAIN will process the 
error number and send the proper error message to SYSOUT for 
display. In the case of a fatal error, MAIN will clean up and 
stop processing. After all the input cards have been read and 
processed, MAIN will perform all tasks necessary to clean up and 
stop processing. 

3. 2. 1.6 Flowchart 


Figure 3.1. 


















3.2.2 SUBROUTINE DEF (Rl) 


DEF (define) takes the input action request passed to it by 
MAIN and determines which one of the level 2 subroutines is to 
be called. The level 2 subroutines for DEF and their sub functions 
are : 


LD 

Name 

Subfunction 

Rl.l 

DEFCTL 

Control 

R1.2 

DEFDIR 

Directory 

Rl. 3 

D’' FDES 

Descriptor 

Rl. 4 

DEFDFN 

Definition 

R1.5 

DEFDAT 

Data 


3. 2. 2.1 Linkages 

DEF calls subroutines DEFCTL, DEFDIR, DEFDES, DESDFN, and 
DEFDAT. It is called only by MAIN. 

3 „ 2 . 2 . 2 Interfaces 

DEF provides the interface between MAIN and the proper interpre- 
tive subroutine . 

3 . 2 . 2 . 3 Inputs 

The input to DEF is a partially parsed action request. 

3. 2. 2. 4 Outputs 

The output from DEF is a partially parsed action request which is 
passed to the proper level 2 subroutine for further action and/ 
or an error message number which is returned to MAIN for action. 
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3 . 2 . 2 . 5 De.scription 

DEF accepts the partially parsed action request from MAIN and 
decides, by examining characters 5 to 7 of the request, which 
subfunction is being requested, and calls that subroutine. If 
the subfunction being requested is not one of those listed, DEF 
will set an error condition and return to MAIN. 

3. 2. 2. 6 Flowchart 
Figure 3.2. 
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FCTL 













3.2.3 SUBROUTINE RPL (R2) 

RPL (replace) takes the input action request passed to it by 
MAIN and determines which one of the level 2 subroutines is to 
be called. The level 2 subroutines for RPL and their sub- 
fimctions are: 


12 

Name 

Subfunction 

R2.1 

RPLCTL 

■ Control 

R2.2 

RPLDIR 

Directory 

R2. 3 

RPLDES 

Descriptor 

R2.4 

RPLDFN 

Definition 

R2-5 

RPLDAT 

Data 


3 . 2 . 3 . 1 Linkages 

RPL calls subroutines RPLCTL, RPLDIR, RPLDES, RPLDFN, and 
RPLDAT, It is called only by MAIN. 

3.2. 3.2 Interfaces 

RPL provides the interface between MAIN and the proper inter" 
pretive subroutine. 

3 . 2 . 3 . 3 Inputs 

The input to RPL is a partially parsed action request. 

3-2. 3. 4 Outputs 

The output from RPL is a partially parsed action request which is 
passt:d to the proper level 2 subroutine for further action and/ 
or an error message number which is returned to MAIN for action. 

3. 2. 3. 5 Description 

RPL accepts the partially parsed action request from MAIN and 
decides, by examining characters 5 to 7 of the request, which 
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subfiinction is being requested and calls that subroutine, 
the subfunction being requested is not one of those listed 
will set an error and return to MAIN. 

3.2. 3.6 Flowchart 
Figure 3.3. 


If 

RPL 
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SET 

ERROR 









3.2.4 SUBROUTINE ADD (R3) 


ADD (add) takes the input action request passed to it by MAIN 
and determines which one of the level 2 subroutines is to be 
called. The level 2 subroutines for ADD and their subfunctions 
are: 


ID 

Name 

Siabfunction 

R3.1 

ADDCTL 

Control 

R3.2 

ADDDIR 

Directory 

R3. 4 

ADDDFN 

Definition 

R3.5 

ADDDAT 

Data 

Linkages 




ADD calls subroutines ADDCTL, ADDDIR, ADDDFN, and ADDDAT. It 
is called only by MAIN. 

3. 2. 4. 2 Interfaces 

ADD provides the interface between MAIN and the proper inter- 
pretive subroutine. 

3. 2 . 4 . 3 Inputs 

The input to ADD is a partially parsed action request. 

3. 2. 4. 4 Outputs 

The output from ADD is a partially parsed action request which is 
passed to the proper level 2 subroutine for further action 
and/or an error number which is returned to MAIN for action. 

3.2. 4.5 Description 

ADD accepts the partially parsed action request from MAIN and 
decides, by examining characters 5 to 7 of the request, which 
subfunction is being requested and calls that subroutine. If 
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the subfunction being requested is not one of those listed 
above, ADD will set an error and return to MAIN. 


3*2. 4. 6 Flowchart 
Figure 3.4. 












3.2.5 SUBROUTINE DEL (R4) 

DEL (delete) takes the input action request passed to it by 
MAIN and determines which one of the level 2 subroutines is to 
be called. The level 2 subroutines for DEL and their subfunctions 
are: 


ID 

Name 

Subfunctions 

R4.1 

DELCTL 

Control 

R4.2 

DELDIR 

Directory 

R4. 4 

DELDFN 

Definition 


3. 2. 5.1 Linkages 

DEL calls subroutines DELCTL, DELDIR and DELDFN. It is called 
only by MAIN. 

3. 2. 5. 2 Interfaces 

DEL provides the interface between MAIN and the proper inter- 
pretive subroutine. 

3 .2 . 5 . 3 Inputs 

The input to DEL is a partially parsed action request. 

3. 2. 5. 4 Outputs 

The output from DEL is a partially parsed action request which is 
passed to the proper level 2 subroutine for further action and/or 
an error number which is returned to MAIN for action. 

3. 2. 5. 5 Description 

DEL accepts the partially parsed action request from MAIN and 
decides, by examining characters 5 to 7 of the request, which 
subfunction is being requested and calls that subroutine. If 
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the subfunction being requested is not one of those listed 
above, DEL will set an error and return to MAIN. 


3 . 2 . 5 . 6 Flowchart 
Figure 3.5. 









3.2.6 SUBROUTINE LST (R5) 

LST (list) takes the input action request passed to it by MAIN 
and determines which one of the level 2 subroutines is to be 
called. The level 2 subroutines for LST and their subfunctions 
are : 


ID 

Name 

Subfunction 

R5.1 

LSTCTL 

Control 

R5 .2 

LSTDIR 

Directory 

R5.3 

LSTDES 

Descriptor 

R5 .4 

LSTDPN 

Definition 

R5.5 

LSTDAT 

Data 

3. 2. 6.1 Linkages 

LST calls subroutines 

LSTCTL, LSTDIR, 

LSTDES, LSTDFN 


LSTDAT. It is called only by MAIN. 

3 . 2 . 6 . 2 Interfaces 

LST provides the interface between MAIN and the proper inter- 
pretive subroutine. 

3.2.6 .3 Inputs 

The input to LST is a partially parsed action request. 

3 . 2 . 6 . 4 Outputs 

The output from LST is a partially parsed action request '•which 
is passed to the proper level 2 subroutine for further action 
and/or an error number which is returned to MAIN for action. 

3. 2. 6. 5 Description 

LST accepts the partially parsed action request from MAIN and 
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decides, by examining characters 5 to 7 of the request, which 
subfunction is being requested and calls that subroutine. If 
the subfunction being requested is not one of those listed above, 
LST will set an error and return to MAIN. 

3.2.6. 6 Flowchart 
Figure 3.6. 
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3,2.7 SUBROUTINE DEPCTL (Rl.l) 

DEFCTL (define control) takes the input action request and parses 
it for parameter (FARM) and section (SECT) data to build the 
control record. 

3. 2. 7.1 Linkages 

DEPCTL calls subroutines PARPRM (XI), PARSEC (X2), and WRITE (Cl). 
It is called only by DEF. 

3.2. 7.2 Interfaces 
None . 

3 . 2 . 7 . 3 Inputs 

The input to DEFCTL is a partially parsed action request. 

3. 2. 7. 4 Outputs 

The output of DEFCTL is a fully defined control record which is 
written to the data base or an error number. 

3. 2. 7. 5 Description 

DEFCTL accepts the action request from DEF and interprets it 
for parameter and section data needed to build the control 
record. It then writes the newly created control record to the 
data base and initializes it with blanks. Any attempt to build 
a control record with incomplete or erroneous data will result in 
an error condition being returned to DEF. 

3.2. 7.6 Flowchart 
Figure 3.7. 
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3.2.8 SUBROUTINE DEFDIR (R1.2) 


DEFDIR (define directory) takes the input action request and 
parses it for parameter and section data to build a directory 
entry . 

3 . 2 . 8 . 1 Linkages 

DEFDIR calls subroutines PARPR14, PARSEC, and WRITE. It is called 
only by DEF. 

3. 2. 8. 2 Interfaces 

DEFDIR updates the proper control record to insure that the 
newly created directory entry is properly referenced. 

3 . 2 . 8 . 3 Inputs 

The input to DEFDIR is a partially parsed action request. 

3 . 2 . 8 . 4 Outputs 

The outputs of DEFDIR are a fully defined directory entry which 
is written to the data base and an updated directory pointer in 
the control record or an error number. 

3. 2. 8. 5 Description 

DEFDIR accepts the action request from DEF and interprets it for 
parameter and section data needed to build the directory entry. 

It then writes the newly created directory entry to the data 
base and updates the directory pointer in the control record 
and rewrites the record. Any attempt to build a directory entry 
with incomplete or erroneous data will result in an error 
condition being returned to DEF. 

3. 2. 8. 6 Flowchart 
Figure 3.8. 
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3.8.- Subroutine DEFDIR .(Rl.2) 


Figure 










3.2.9 SUBROUTINE DEPDES (R1.3) 


DEFDES (define descriptor) takes the input action request and 
parses it for parameter and section data to build a descriptor 
entry. 


3. 2. 9.1 Linkages 

DEFDES calls subroutines PARPRM, PARSEC, and WRITE. It is called 
only by DEP. 

3. 2. 9. 2 Interfaces 

DEFDES updates the proper control record and correct directory 
entry to insure that the newly created descriptor entry has the 
proper pointers. 

3.2 .9 . 3 Inputs 

The input to DEPDES is a partially parsed action request. 

3. 2. 9. 4 Outputs 

The outputs of DEPDES are a fully defined descriptor entry which 
is written to the data base and an updated control record and 
directory entry or an error number. 

3. 2. 9. 5 Description 

DEFDES accepts the action request from DEP and interprets it 
for parameter and section data needed to build the descriptor 
entry. It then writes the newly created descriptor entry to the 
data base and updates the control record and correct directory 
entry for proper descriptor pointers, and rewrites them to the 
data base. Any attempt to build a descriptor entry with incom- 
plete or erroneous data will result in an error condition being 
returned to DEP. 
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3 . 2 . 9 . 6 Flowchart 


Figure 3.9 









3.2.10 SUBROUTINE DEFDPN (R1.4) 


DEFDFN (define definition) takes the input action request and 
parses it for parameter and section data to build a definition 
record. 


3.2.10.1 Linkages 

DEFDFN calls subroutines PARPRM, PARSEC, and WRITE. It is called 
only by DEF. 

3.2.10.2 Interfaces 

DEFDEN updates the proper control record and correct directory 
entry to insure that the newly created definition record has the 
proper pointers . 

3.2.10.3 Inputs 

The input to DEFDFN is a partially parsed action request. 

3.2.10.4 Outputs 

The outputs of DEFDFN are a fully defined definition record 
which is written to the data base and an updated control record 
and directory entry or an error number. 

3.2.10.5 Description 

DEFDFN accepts the action request from DEF and interprets it 
for parameter and section data needed to build the model 
definition record. It then writes the newly created definition 
record to the data base and updates the control record and correct 
directory entry for proper definition pointers and rewrites them 
to the data base. Any attempt to build model definition record 
with incomplete or erroneous data will result in an error 
condition being returned to DEF. 
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3.2.10.6 Flowchart 


Figure 3 . 10 . 
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3.2.11 SUBROUTINE DEPDAT (R1.5) 

DEPDAT (define data) takes the input action request and parses 
it for parameter and section data to build the data records. 

3.2.11.1 Linkages 

DEPDAT calls subroutines PARPRM, PARSEC, and WRITE. It is 
called only by DEP. 

3.2.11.2 Interfaces 

DEPDAT updates the proper control record and correct directory 
entry to insure that the newly created data records have the 
proper pointers . 

3.2.11.3 Inputs 

The input to DEPDAT is a partially parsed action request. 

3.2.11.4 Outputs 

The outputs of DEPDAT are fully defined data records which are 
written to the data base and an updated control record and 
directory entry or an error number. 

3.2.11.5 Description 

DEPDAT accepts the action request from DEP and interprets it 
for parameter and section data needed to build the data records. 
It then writes the newly created data records to Phe data base 
and updates the control record and correct directory entry for 
proper data pointers and rewrites them to the data base. Any 
attempt to build data records with incomplete or erroneous data 
will result in an error condition being returned to DEP. 

3.2.11.6 Flowchart 


Figure 3.11. 









3.2.12 SUBROUTINE RPLCTL (R2.1) 

RPLCTL (replace coxxtrol) takes the input action request and 
parses it for data to update the proper control record. 

3.2.12.1 Linkages 

RPLCTL calls subroutines PARPRM, PARSEC, and WRITE. It is called 
only by RPL. 

3.2.12.2 Interfaces 
None 


3.2.12.3 Inputs 

The input to RPLCTL is a partially parsed action request. 

3.2.12.4 Outputs 

The output of RPLCTL is an updated control record or an error 
number. 


3.2.12.5 Description 

RPLCTL accepts the action request from RPL and interprets it 
for the data necessary to update the proper control record. 

It then rewrites the updated record to the data base. Any 
attempt to update the control record with incomplete or erroneous 
data will result in an error condition being returned to RPL. 

3.2.12.6 Flowchart 
Figure 3.12. 


3-33 







3.2.13 SUBROUTINE RPLDIR (R2.2) 


RPLDIR (replace directory) takes the input action request and 
parses it for data to update the proper directory entry. 

3.2.13.1 Linkages 

RPLDIR calls subroutines PARPRM, PARSEC, and WRITE. It is called 
only by RPL. 

3.2.13.2 Interfaces 
None . 

3.2.13.3 Inputs 

The input to RPLDIR is a partially parsed action request. 

3.2.13.4 Outputs 

The output of PJ>LDIR is an updated directory entry or an error 
number. 


3.2.13.5 Description 

RPLDIR accepts the action request from RPL and interprets it 
for the data necessary to update the proper directory entry. 

It then rewrites the updated directory entry to the data base. 
Any attempt to update a directory entry with incomplete or 
erroneous data will result in an error condition being returned 
to RPL. 


3.2.13.6 Flowchart 
Figure 3.13. 
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3.2.14 SUBROUTIiSfE RPLDES (R2.3) 


RPLDES (replace descriptor) takes the input action request and 
parses it for data to update the proper descriptor entry. 

3.2.14.1 Linkages 

RPLDES calls subroutines PARPRM, PARSEC, and WRITE. It is called 
only by RPL. 

3.2.14.2 Interfaces 
None . 


3.2.14.3 Inputs 

The input to RPLDES is a partially parsed action request. 

3.2.14.4 Outputs 

The output of RPLDES is an updated descriptor entry or an error 
number . 


3.2.14.5 Description 

RPLDES accepts the action request from RPL and interprets it 
for the data necessary to update the proper descriptor entry. 

It then rewrites the updated descriptor entry to the data base. 
Any attempt to update a descriptor entry with incomplete or 
erroneous data will result in an error condition being returned 
to RPL. 


3.2.14.6 Flowchart 
Figure 3.14. 
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3.2.15 SUBROUTINE RPLDFN (R2.4) 

RPLDFN (replace definition) takes the input action request and 
parses it for data to update the proper model definition record. 

3.2.15.1 Linkages 

RPLDFN calls subroutines PARPRM, PARSEC, and WRITE. It is called 
only by RPL. 

3.2.15.2 Interfaces 
None . 


3.2.15.3 Inputs 

The inpi^t to RPLDFN is a partially parsed action request. 

3.2.15.4 Outputs 

The output of RPLDFN is an updated' model definition record or 
an error number. 

3.2.15.5 Description 

RPLDFN accepts the action request from RPL and interprets it 
for the data necessary to update the proper model definition 
record. It then rewrites the updated record to the data base. 
Any attempt to update a model definition with incomplete or 
erroneous data will result in an error condition being returned 
to RPL. 


3.2.15.6 Flowchart 
Figure 3.15. 
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3.2.16 SUBROUTINE RPLDAT (R2.5) 

RPLDAT (replace data) takes the input action request and parses 
it for data to update the proper data record (s). 

3.2.16.1 Linkages 

RPLDAT calls subroutines PARPRM, PARSEC, and WRITE. It is 
called only by RPL. 

3.2.16.2 Interfaces 
None . 

3.2.16.3 Inputs 

The input to RPLDAT is a partially parsed action request. 

3.2.16.4 Outputs 

The output of RPLDAT is an updated data record (s) or an error 
number. 

3.2.16.5 Description 

RPLDAT accepts the action request from RPL and interprets it for 
the data necessary to update the proper data record (s). It then 
rewrites the updated record (s) to the data base. Any attempt to 
update a data record with incomplete or erroneous data will 
result in an error condition being returned to RPL. 

3.2.16.6 Flowchart 
Figure 3.16,, 
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3.2.17 SUBROUTINE ADDCTL (R3.1) 

ADDCTL (add control) takes the input action request and parses 
it for data to add to the proper control record. 

3.2.17.1 Linkages 

ADDCTL calls the subroutines PARPRM, PARSEC, and WRITE. It is 
called only by ADD. 

3.2.17.2 Interfaces 
None. 


3.2.17.3 Inputs 

The input to ADDCTL is a partially parsed action request. 

3.2.17.4 Outputs 

The output of ADDCTL is an updated control record or an error 
number . 


3.2.17.5 Description 

ADDCTL accepts the action request from ADD and interprets it 
for the password to be added to the proper control record. It 
then rewrites the updated record to the data base. Any attempt 
to add to the control record with incomplete or erroneous data 
will result in an error condition being returned to ADD. 

3.2.17.6 Flowchart 
Figure 3.17. 
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3.2.18 SUBROUTINE ADDDIR (R3.2) 

ADDDIR (add directory) takes the input action request and parses 
it for data to be added to the proper directory entry. 

3.2.18.1 Linkages 

ADDDIR updates the proper control record to insure that the 
added directory element is properly referenced. 

3.2.18.3 Inputs 

The input to ADDDIR is a partially parsed action request. 

3.2.18.4 Outputs 

The output of ADDDIR is an updated directory entry and an updated 
control record or an error number. 

3.2.18.5 Description 

ADDDIR accepts the action request from ADD and interprets it 
for the data to be added to the correct directory entry. It 
then updates the proper control record and rewrites both to the 
data base . Any attempt to add to a directory entry with incom- 
plete or erroneous data will result in an error condition being 
returned to ADD. 

3.2.18.6 Flowchart 
Figure 3.18. 
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Figure 3.13.- Subroutine ADDDIR (R3,2). 
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3.2.19 SUBROUTINE ADDDFN (R3.4) 


ADDBPN (add definition) takes the input action request and parses 
it for new data to be added to the correct definition record. 

3.2.19.1 Linkages 

ADDDFN calls the subroutines PARPRM, PARSEC, and WRITE. It is 
called only by ADD. 

3.2.19.2 Interfaces 
None. 


3.2.19.3 Inputs 

The input to ADDDFN is a partially parsed action request. 

3.2.19.4 Outputs 

The output of ADDDFN is an updated definition record or an 
error number. 

3.2.19.5 Description 

ADDDFN accepts the action request from ADD and interprets it for 
the data to be added to the correct definition record. It then 
rewrites the definition record to the data base. Any attempt to 
add to a definition with incomplete or erroneous data will result 
in an error condition being returned to ADD. 

3.2.19.6 Flowchart 


Figure 3.19. 
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3.2.20 SUBROUTINE ADDDAT (R3.5) 

ADDDAT (add data) takes the input action request and parses it 
for new data to be added to the correct data record (s). 

3.2.20.1 Link ages 

ADDDAT calls the subroutines PARPRM, PARSEC, and WRITE. It is 
called only by ADD. 

3.2.20.2 Interfaces 
None . 


3.2.20.3 Inputs 

The input to ADDDAT is a partially parsed action request. 

3.2.20.4 Outputs 

The output of ADDDAT is an updated data record (s) or an error 
number . 

3.2.20.5 Description 

ADDDAT accepts the action request from ADD and interprets it for 
the data to be added to the correct data record (s) It then 
rewrites the data record (s) to the data base. Any attempt to 
add incomplete or erroneous data will result in an error con- 
dition being returned to ADD. 

3.2.20.6 Flowchart 


Figure 3.20. 





Figure 3.20.- Subroutine ADDDAT (R3.5) 
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3.2.21 SUBROUTINE DELCTL (R4.1) 

DELCTL (delete control) takes the input action request and parses 
it to determine what is to be deleted from the control record. 

3 . 2 . 2 3. . 1 Linkages 

DELCTL calls the subroutines PARPRM, PARSEC, and WRITE. It is 
called only by DEL. 

3.2.21.2 Interfaces 
None . 


3.2.21.3 Inputs 

The input to DELCTL is a partially parsed action request. 

3.2.21.4 Outputs 

The output of DELCTL is an updated control record or an error 
number. 


3.2.21.5 Description 

DELCTL accepts the action request from DEL and interprets it for 
the password to be deleted from the proper control record. It 
then rewrites the updated record to the data base. Any attempt 
to delete a password with incomplete or erroneous data will 
result in an error condition being returned to DEL. 

3.2.21.6 Flowchart 


Figure 3.21. 



Figure 3/21.- Subroutine DELCTL (R4.1) 
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3.2.22 SUBROUTINE DELDIR (R4.2) 

DELDIR (delete directory) takes the input action request and 
parses it to determine what is to be deleted from the correct 
directory entry. 

3.2.22.1 Linkages 

DELDIR calls the subroutines PARPRM, PARSEC, and WRITE. It is 
called only by DEL. 

3.2.22.2 Interfaces 

DELDIR updates the proper control record to insure that the 
deleted directory element references are deleted. 

3.2.22.3 Input s 

The input to DELDIR is a partially parsed action request. 

3.2.22.4 Outputs 

The output of DELDIR is an updated directory entry and an up- 
dated control record or an error number. 

3.2.22.5 Description 

DELDIR accepts the action request from DEL and interprets it to 
determine which directory elements of the correct directory 
entry are to be deleted. It then updates the proper control 
record and rewrites both to the data base. Any attempt to 
delete a directc ry element with incomplete or erroneous data 
will result in an error condition being returned to DEL. 

3.2.22.6 Flowchart 
Figure 3.22. 
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Figure 3.22..- Subroutine DELDIR (R4.2) 
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3.2.23 SUBROUTINE DELDPN (R4.4) 

DELDFN (delete definition) takes the input action request and 
parses it to determine what part of the correct definition is 
to be deleted. 

3.2.23.1 Linkages 

DELDFN calls the subroutines PARPRM, PARSEC, and WRITE. It is 
called only by DEL. 

3.2.23.2 Interfaces 
None. 


3.2.23.3 Inputs 

The input to DELDFN is a partially parsed action request. 

3.2.23.4 Output 

The output of DELDPN is an updated definition record or an 
error number. 

3.2.23.5 Description 

DELDPN accepts the action request from DEL and interprets it to 
determine what part of the model definition record is to be 
deleted. It then rewrites the updated record to the data base. 
Any attempt to delete any portion of a model definition record 
with incomplete or erroneous data will result in an error con- 
dition being returned to DEL. 

3.2.23.6 Flowchart 
Figure 3.23. 


3-55 



3-56 





3.2.24 SUBROUTINE LSTCTL (R5.1) 

LSTCTL (list control) takes the input action request and parses 
it to determine how much of the proper control record is to be 
listed and prints that portion. 

3.2.24.1 Linkages 

LSTCTL calls subroutines PARPRM and PARSEC. 

3.2.24.2 Interfaces 
None. 


3.2.24.3 Inputs 

The input to LSTCTL is a partially parsed action request. 

3.2.24.4 O utputs 

The output of LSTCTL is a formatted listing of the requested 
portions of the selected control record or an error number. 

3.2.24.5 Description 

LSTCTL accepts the action request from LST and interprets it to 
determine what control record is to be listed and what parts 
are to be selected for printing. It then reformats the selected 
portions for listing on the printer. Any attempt to list a 
control record with incomplete or erroneous data will result in 
an error condition being returned to LST. 

3.2.24.6 Flowchart 
Figure 3.24. 
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3.2.25 SUBROUTINE LSTDIR (R5.2) 

LSTDIR (list directory) takes the input action request and parses 
it to determine how much of the selected directory entry is to 
be listed and prints that portion. 

3.2.25.1 Linkages 

LSTDIR calls subroutines PARPRM and PARSEC. 

3.2.25.2 Interfaces 
None . 

3.2.25.3 Inputs 

The input to LSTDIR is a partially parsed action request. 

3.2.25.4 Outputs 

The output of LSTDIR is a formatted listing of the requested 
portions of the selected directory entry or an error number. 

3.2.25.5 Description 

LSTDIR accepts the action request from LST and interprets it to 
determine what directory entry is to be listed and what parts 
are to be selected for printing. It then reformats the selected 
portions for listing on the printer. Any attempt to list a 
directory entry with incomplete or erroneous data will result 
in an error condition being returned to LST. 

3.2.25.6 Flowchart 
Figure 3.25. 


3-59 








3.2.26 SUBROUTINE LSTDES (R5.3) 

LSTDES (list descriptor) takes the input action request and parses 
it to determine how much of the selected descriptor entry is to 
be listed and prints that portion. 

3.2.26.1 Linkages 

LSTDES calls the siibroutines PARRRM and PARSEC. 

3.2.26.2 Interfaces 
None. 

3.2.26.3 Inputs 

The input to LSTDES is a partially parsed action request. 

3.2.26.4 Outputs 

The output of LSTDES is a formatted listing of the requested 
portions of the selected descriptor entry or an error number. 

3.2.26.5 Description 

LSTDES accepts the action request from LST and interprets it to 
determine what descriptor entry is to be listed and what parts 
are to be selected for printing. It then reformats the selected 
portions for listing on the printer. Any attempt to list a 
descriptor entry with incomplete or erroneous data will result 
in an error condition being returned to LST. 

3.2.26.6 Flowchart 


Figure 3.26. 







3.2.27 SUBROUTINE LSTDPN (R5.4) 


LSTDFN (list definition) takes the input action request and parses 
it to deterwine how much of the selected definition record is to 
be listed and prints that portion. 

3.2.27.1 Linkages 

LSTDFN calls the subroutines PARPRM and PARSEC. 

3.2.27.2 Interfaces 
None , 


3.2.27.3 Inputs 

The input to LSTDFN is a partially parsed action request. 

3.2.27.4 Outputs 

The output of LSTDFN is a formatted listing of the requested 
portions of the selected model definition or an error number. 

3.2.27.5 Description 

LSTDFN accepts the action request from LST and interprets it to 
determine what model definition is to be listed and what parts 
are to be selected for printing. It then refo;rmats the selected 
portions for listing on the printer. Any attempt to list a model 
definition record with incomplete or erroneous data will result 
in an error condition being returned to LST. 

3.2.27.6 Flowchart 


Figure 3.27. 




3.2.28 SUBROUTINE LSTDAT (R5.5) . 

LSTDAT (list data) takes the input action request and parses 
it to determine how much of the selected data record (s) is to be 
listed and prints that portion. 

3.2.28.1 Linkages 

LSTDAT calls the subroutines PARPRM and PARSEC. 

3.2.28.2 Interfaces 
None . 

3.2.28.3 Inputs 

The input to LSTDAT is a partially parsed action request. 

3.2.28.4 Outputs 

The output of LSTDAT is a formatted listing of the requested 
portions of the selected data record (s) or an error number. 

3.2.28.5 Description 

LSTDAT accepts the action request from LST and interprets it to 
determine what data record (s) is to be listed and what parts 
are to be selected for printing. It then reformats the selected 
portions for listing on the printer. Any attempt to list data 
using an incomplete or erroneous request will result in an 
error condition being returned to LST. 

3.2.28.6 Flowchart 
Figure 3.28. 
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3.2.29 SUBROUTINE PARPRM (XI) 


PARPRM (parse parameter) takes the input action request and parses 
it to determine the sections (see 3.2.32) to be subsequently 
processed. 


3.2.29.1 Linkages 
To be determined. 

3.2.29.2 Interfaces 
To be determined. 

3.2.29.3 Inputs 

The input to PARPRM is a partially parsed action request. 

3.2.29.4 Outputs 

The output of PARPRM is a partially parsed action request, 
interpreted section name(s), and the applicable data base 
record ( s ) /entry ( ies ) . 

3.2.29.5 Description 

PARPRM accepts the action request from its calling routine, parses 
the section name from the request, and determines whether the 
section name is legitimate. It then opens the applicable file, 
checks security, , and reads the record (s) /entry (ies) of interest 
into core. If an error is detected in the input request, an 
error condition is set and control is returned to the calling 
routine . 

3.2.29.6 Flowchart 
Figure 3.29. 
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Figure 3.29.- Subroutine PARPRM (XI). 
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3.2.30 SUBROUTINE PARSEC (X2) 


PARSEC (parse sections) takes the input action request and parses 
it for the subparameters (see Appendix A) and data necessary to 
accomplish the task(s) called for by the section name(s). 

3.2.30.1 Linkages 
To be determined. 

3.2.30.2 Interfaces 
To be determined. 

3,2,30-3 Inputs 

The inputs to PARSEC are a partially parsed action request, 
interpreted section name(s), and the applicable data base 
record ( s ) /entry ( ies ) . 

3.2.30.4 Outputs 

The output of PARSEC is an updated record (s ) /entry (ies ) which is 
ready for writing to the data base or (in the case of LST) a 
completely formatted listing to the printer or (in the case of 
an error) an error number. 

3.2.30.5 Description 

PARSEC accepts the action request from its calling routine, 
parses the rest of the request for section data, determines 
v;hether the section data (subparameters) are legitimate, and 
applies the parsed data to the record (s) /entry (ies) in core, in 
accordance with the tasking implied by the section name. It 
then either moves the updated record (s) /entry (ies) to the output 
area for rewriting to the data base or (in the case of LST) 
reformats the record (s ) /entry (ies ) for listing and moves it 
to SYSOUT for printing. If an error is detected during processing 
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an error condition is set and control is returned to the 
calling routine. 


3.2.30.6 Flowchart 
Figure 3.30. 




?.2.31 SUBROUTINE WRITE (Cl) 


WRITE takes the updated record from the output area and writes 
it to the data base . 

3.2.31.1 Linkages 
To be determined. 

3.2.31.2 Interfaces 
To be determined. 

3.2.31.3 Inputs 

The input to WRITE is an updated/newly defined record in the 
output area. 

3.2.31.4 Output 

The output from WRITE is an updated/newly defined record which 
is written to the data base. 

3.2.31.5 Description 

Using its calling argument as the decision parameter, WRITE 
writes the record from the output area to the proper area in the 
data base. In the case of an error, WRITE will set an error 
condition and return control to its calling routine. 

3.2.31.6 F1p-> chart 
Figure 3.31. 
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3.2.32 SUBFUNCTION STRUCTURES AND FORMATS 


3.2.32.1 Control Record Structure 


DCL 1 CTL EXTERNAL, 

2 SEC, 

3 FILEID 
3 NUMPASS 
3 PASSWORD (8) 

3 RESERVED 
3 NUMDIR 
3 NUMREC 
3 NUMDES 
3 NUMDEF 
3 NUMDAT 
2 DTY, 

3 DIRIDNUM(8) 

3 DIRIDCHR(S) 

3 DIRNOREC(8) 

3 DIRTOTDE(8) 

3 DIRLOCAT(8,4) 
3 DIRNUMDE ( 8 , 4 ) 
2 DSY, 

3 DESID(16) 

3 DESLOCAT(16) 

3 DESDISPLC16) 

2 DFY, 

3 DEFID(200) 

3 DEFLOCAT(200) 
3 DEFDISPL(200) 
2 DAY, 

3 DATID(200) 

3 DATDESID(200) 
3 DATBLKSZ (200) 
3 DATBKALC(200) 
3 DATBKUSE(200) 
3 DATNOREC(20 0) 
3 DATPOINT(200) 
3 DATLOCAT(456) 
3 DATDISPL(456) 
3 DATRBALC(456) 
3 DATRBUSE{456) 
3 DATPBKID(456) 
3 DATNXARRC456) 
2 REC, 

3 RECTYPE(456) 

3 RECSPACE(456) 
3 RECLOCAT(456) 


CHAR (8) , 

FIXED BIN (15,0) , 
CHAR(8) , 

CHAR (2 8) , 

FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 

FIXED BIN (15,0) , 
CHAR ( 4 ) , 

FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXEt LIN (15,0), 
FIXED BIN (15,0) , 

FIXED BIN (15,0) , 
FIXED BIN(15,0) , 
FIXED BIN(15,0) , 

FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15 ,0) , 

FIXED BIN(31,0) , 
FIXED BIN(15.0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15 ,0) , 
FIXED BIN (15,0), 
FIXED BIN(15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0), 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 

FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0); 


3-74 


3.2.32.2 Subfunction Control Format 


functions applicable sections 


DEF 

CLl, 

SEC, DTY, 

DSY, DFY, DAY, REC 

RPL 

CL2, 

SEC, DSY, 

DFY, DAY, 

ADD 

CL2, 

SEC 


DEL 

CL2, 

SEC, DSY, 

DFY 

LST 

CL2, 

SEC, DTY, 

DSY, DFY, DAY, REC, ALL 

section 

parm/subparm 

abv. 

description 

CLl 

DDNAME=(c) 

DD= ( 

JCL DD name 


NUMSECS= (n) 

NC=( 

number of sections used in 
this run (max=3) 


SECTlONS=(c) 

SC=( 

section names 

CL2 

DDNAME=(c) 

DD= ( 

JCL DD name 


FILE ID-- (c) 

ID=( 

file identification name 


PASSWORD= (c) 

PW= ( 

password that can access the file 


NUMSECS =(n) 

NC=( 

number of sections used in this 
run (max=7) 


SECl’IONS=(c) 

sc-{ 

section names 

SEC 

FILRID=(c) 

II 

Q 

H 

file identification name (1-8 
characters ) 


NUMPASS=(n) 

II 

# passwords that can access 
the file (max=8) 


PASSWORD^ (c) 

PW=( 

passwords that can access the file 


RESERVED= (c) 

RV=( 

extra space or filler 


NUMDIR=(n) 

ND= ( 

# of countries on the file (max= 
8 ) 

# of records on file, excluding 
control rec. 


NUMREC ^(n) 

FR= ( 


NUMDES= (n) 

NS= ( 

# of descriptors found on the file 


NUMDEF=(n) 

NF=( 

# of model definitions found on 
the file 


NUMDAT= (n) 

NT=( 

# of directory elements with 
data on the file 


SUBRANGE^ (n) 

SR=( 

range of values in subscript 
array to be considered 

REC 

RECTYPE =(n) 

RT=( 

record type 


RECSPACE =(n) RS=( 

freespace on record (bytes) 


RELOCAT=(n) RC=( 

SUBRANGE =(n) SR= ( 

record # 
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Subfunction Control Format, continued 


DTY 

DIRIDNUM=(n) 
DIRIDCHR=(c) 
DIRNOREC= (n ) 

DI= ( 
DC= ( 
DR= ( 


DIRTOTDE=(n) 

DT= ( 


DIRLOCAT=(n) 

DL= ( 


DIRNUMDE=(n) 

DE= ( 


SUBRAN GE= (n) 

SR= ( 

DSY 

DESID= (n) 

SI=( 


DESLOCAT=(n) 

DESDISPL=(n) 

SL= ( 
SP= ( 


SUBRANGE=(n) 

SR=( 

DFY 

DEPID=(n) 

FI=( 


DEPLOCAT=(n) 

FL=( 


DEFDISPL=(n) 

FP={ 


SUBRANGE=(n) 

SR=( 

DAY 

DATID=(n) 

TI=( 


DADESID= (n) 

TD=( 


DATBLKS=(n) 
DATBKALC= (n) 
DATBKUSE=(n) 
DATNOREC=(n) 

BS=( 

TB=( 

TU=( 

TN=( 


DATPOINT=(n) 

DATLOCAT=(n) 

DATDISPL=(n) 

DATRBALC=(n) 

TP=( 

TL=( 

TH=( 

T0=( 


DATRBUSE=(n) 
DATFBKID=(n) 
DATNXARR =(n) 

TZ=( 

TF={ 

TX=( 


SUBRANGE =(n) 

SR={ 

ALL 

SUBRANGE=(n) 

SR=( 


numeric country codes 
alphabetic country codes 

# of directory records per 
country 

total # of directory elements 
per country 

record number of each directory 
record 

# of directory elements per 
directory record 

range of values in subscript 
array to be considered 

identification #'s of descrip- 
tors on file 

record number of each descriptor 
byte # of beginning of each 
descriptor 


identification #'s of model 
definition 

record number of each model 
definition 

byte # of beginning of each def- 
inition 


directory ID # of each area 
v/ith data on the file 
ID # of descriptor for data in 
this block 

#bytes in data block 
total # of blocks allocated 
total # blocks used 

# records used for this 
directory element's data 
subscript of data location array 
record # for data 

byte # of beginning of data 
#blocks allocated for this data 
on record 

# blocks used for this data 
first block ID 

pointer to next subscript of 
data location array 
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3.2.32.3 Directcry Structure 
DCL 1 DIR (26 8) , 


2 

DID, 




3 

NUMLEVEL 

FIXED 

BIN(15,0) , 


3 

DIRID 

FIXED 

BIN (15 ,0) , 


3 

DIRNAME 

CHAR (16) , 


3 

NUMBDES 

FIXED 

BIN(15,0) , 


3 

NUMBDEF 

FIXED 

BIN (15,0) , 

2 

PTR, 




3 

PARENT 

FIXED 

BIN(15,0) , 


3 

BROTHER 

FIXED 

BIN (15,0) , 


3 

CHILD 

FIXED 

BIN(15,0) , 

2 

DSC, 




3 

DESID(3) 

FIXED 

BIN(15,0) , 


3 

DESLOCAT ( 3 ) 

FIXED 

BIN(15,0) , 


3 

DESDISPLU) 

FIXED 

BIN(15,0) . 

2 

DTA, 




3 

DATLOCAT(3) 

FIXED 

BIN(15,0) , 


3 

DATDISPL(3) 

FIXED 

BIN(15,0) , 

2 

DPN, 




3 

DEFID (6) 

FIXED 

BIN(15,0) , 


3 

DEFLOCAT(6) 

FIXED 

BxN(15,0) , 


3 

DEFDISPL(6) 

FIXED 

BIN (15,0) ; 
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3.2.32.4 Directory Subfunc tion Format 


functions applicable sections 



DBF 

DRl, DID, 

DSC, 

DTA, 

DFN, PTR, DTY, REC 


RPL 

DR2, DID, 

PTR, 

DSC, 

DTA, DFN 


ADD 

DR2, DID, 

DSC, 

DTA, 

DFN, PTR, DTY, REC 


DEL 

DR2, DLE, 

PTR, 

DTY, 

REC, 


LST 

DR,2, DID, 

PTR, 

DSC, 

DTA, DFN, ALL 

section 

parm/subparm 


abv. 

description 

DRl 


DDNAME=(c) 


DD=( 

JCL DD name 



FILEID=(c) 


ID= ( 

file identification name 



PASSWORD =(c) 


PW=( 

password that can access 
the file 



NUMSECS=(n) 


NC=( 

number of sections used in this 
run (max=7) 



SECTIONS =(c) 


SC={ 

section names 

DR2 


DDNAME =(c) 


DD=( 

JCL DD name 



FILEID = (c) 


ID=( 

file identification name 



PASSWORD = (c) 


PS=( 

password that can access the file 



COUNTRY = (n) 


CO=^( 

number of country in question 



NUMSECS = (n) 


NC=( 

number of sections used 
in this run (max=7) 



SECTIONS = (c) 


SC=( 


DID 


DIRID=(n) 


RI=( 

id # of lowest level of direc- 
tory in question 



DIRNAME = (c) 


DN=( 

name of directory level in 
question 



NUMBDES =(n) 


NS=( 

descriptor number used by this 
directory elem 



NUMBDEF =(n) 


NF=( 

model defn # used by this 
directory element 



NUMLEVEL=(n) 


NL={ 

number of levels 



LEVELS =(n) 


LV=( 

level numbers 



SUBRANGE =(n) 


SR=( 

range of values in subscript 

PTR 


LEVELS =(n) 


LV=( 




PARENT^ (n) 


PA=( 

parent of directory element 
in question 



BROTHER=(n) 


BR=( 

brother of directory elem, in 
question 



CHILD= (n) 


CH={ 

child of directory elem in 
question 



SUBRANGE =(n) 


SR=( 




NUMLEVEL =(n) 


NL=( 
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Directory Subfimction Format, continued 


DSC 

DESID= (n) 

II 

H 

CO 


DESLOCAT= (n) 

SL=( 


DESDISPL= (n) 

SP= ( 


NUMLEVEL= (n) 

NL=( 


LEVEL S= (n) 

LV= ( 


SUBRANGE=(n) 

SR= ( 

DTA 

DATLOCAT=(n) 

II 


DATDISPL=(n) 

TH=( 


NUMLEVEL=(n) 

NL=( 


LEVELS= (n) 

LV=( 


SUBRANGE= (n) 

SR=( 

DFN 

DEPID=(n) 

H 

II 


DEPLOCAT=(n) 

II 


DEFDISPL=(n) 

FP=( 


NUMLEVEL= (n) 

NL=( 


LEVELS=(n) 

LV«=( 


SUBRANGE=(n) 

SR=( 

DLE 

NUMLEVEL=(n) 

NL=( 


LEVELS=(n) 

LV=( 

REG 

RECTYPE=(n) 

RT=( 


RECSPACE=(n) 

RS=( 


RELOCAT={n) 

RC=( 

DTY 

DIRIDNUM=(n) 

DI=( 


DIRIDCHR=(c) 

DC={ 


DIRNOREC=(n) 

DR=( 


DIRTOTDE= (n) 

DT=( 


DIRLOCAT'=-= (n) 

DL=( 


DIRNUMDE={n) 

DF,= ( 


SUBRANGE=(n) 

SR=( 

ALL 

SUBRANGS= (n) 

SR==( 


NUMLEVEL= (n) 

NL=( 


LEVELS=(n) 

LV= ( 


# of descriptor for this direc- 
tory element 

record # of descriptor for this 
directory elem 

byte # of beginning of descriptor 


record number of data for this 
directory 

byte # of beginning of data 


id # of model defn for this 
directory elem 

record number of model def for 
this directory 

byte # of beginning of model 
definition 


record type 

freespace on record (bytes) 
record # 

numeric country codes 
alphabetic country codes 

# directory records per country 
total # directory elements per 
country 

record # of each directory record 

# directory elements per 
directory record 
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3.2.32.5 Descriptor Structure 
DCL 1 DBS EXTERNAL, 


2 PLM, 


3 

DESID 

FIXED BIN (15,0) , 

3 

BLKSIZE 

FIXED BIN (15,0) , 

3 

NUMBLKS 

FIXED BIN (15,0) , 

3 

NUMVARBL 

FIXED BIN (15,0) , 

3 

TOTCODES 

FIXED BIN 0.5, 0) , 

3 

TOTUNITS 

FIXED BIN j,0) , 

3 

RESERVED 

CHAR (16) , 

IDS, 


3 

CODEID(56/ 

FIXED BIN (15,0) , 

3 

CODENAME (56) 

CHAR (16) , 

3 

CODEABV(56) 

CHAR (4) , 

3 

UNITID (20) 

FIXED BIN (15,0) , 

3 

UNITNAME (20) 

CHAR (16) , 

3 

UNITABV(20) 

CHAR (4) , 

COD, 


3 

CODLOCAT(20) 

FIXED BIN (15,0) , 
FIXED BIN (15,0) , 

3 

UNTLOCAT (20) 

3 

BASE (20) 

FIXED BIN (15,0) , 

3 

SCALE (20) 

FIXED BIN (15,0) , 

3 

OUTFIELD (20) 

FIXED BIN (15,0) , 


BLKLOCAT(20) 

FIXED BIN (15,0) , 

3 

NUMELEM(20) 

FIXED BIN (15,0) , 

3 

ELMLOCAT(20,31) 

FIXED BIN (15,0) ; 


3.2.32.6 Subfunction Descriptor Format 


functions applicable sections 


DBF 

RPL 

LST 

DSl, PLM, IDS, COD 

DS 2, PLM, IDS, COD 
DS2, PLM, IDS, COD 

section 

parm/subparm 

abv. 

DSl 

DDNAME= (c) 
FILEID= (c) 
PASSWORD= (c) 
NUMSECS=(n) 

DD= ( 
ID= ( 
PW=( 
NC={ 


SECTIONS=(c) 
COUNTRY= (n) 

SC=( 

C0=( 

DS2 

DDNAME= (c) 
FILEID= (c) 
PASSWORD= (c) 
DESID= (n) 
NUMSECS= (n) 

DD= { 
ID= ( 
PW=( 
SI= ( 
NC=( 


SECTIONS=(c) 

SC=( 

PLM 

DESID= (n) 

SI=( 


BLKSIZE= (n) 
NUMBLKS= (n) 

BS= ( 
NB= ( 


NUMVARBL= (n) 
TOTUNITS=(n) 

NV=( 

TS=( 


TOTCODES= (n) 
RESERVED=( c) 

TC=( 

RV=( 

IDS 

CODEID= (n) 
CODENAME= ( c ) 
CODEABV= (c) 
UNITID= (n) 
UNITNAME= (c) 
UNITABV= (c) 
SUBRANGE= (n) 

CI=( 
CN= ( 
CA= ( 
UI= ( 
UN= ( 
UA= ( 
SR= ( 


DSC,DSY,REC 

ALL 

description 
JCL DD name 

file identification name 
password that can access the file 
number of sections used in this 
run (max=6) 
section names 
country ID 

JCL DD name 

file identification name 
password that can access the file 
identification # of this descriptor 
number of sections used in this 
run (max=6) 
section names 

identification # of this 
descriptor 

# bytes in data block 

# iilocks in this descriptor's 
data blocks 

# variables in this descriptor 
total # of units in this des- 
criptor 

total # of codes 
free space or filler 

code # for variable 
variable name 
variable abbreviation 
variable unit code # 
variable unit name 
variable unit abbreviation 
range of values in subscript 
array to be considered 


3-81- 



COD 

CODLOCAT= (n) 

CL=( 

position in code array 


UNTLOCAT= (n) 

UL= ( 

position in lanit array 


BASE =(n) 

BA=( 

type of variable 


SCALE={n) 

SE=( 

location of decimal point, if any 


OUTFIELD= (n) 

OF= ( 

output print field size 


BLKLOCAT= (n) 

BL= ( 

where variable is located in 
data block 


NUMELEM= (n) 

NE=( 

# subelements (#months, #crops, 
etc . ) 


ELMLOCAT=(n) 

EL= ( 

positions in subelement array 
to be considered 


SUBRANGE= (n ) 

SR= ( 

range of values in subscrxpt 
array to be considered 

DSC 

NUMLBVEl.= (n) 

NL=i 



LEVELS= (n) 

LV= ( 



DESID=(n) 

SI=( 

ID # of descriptor 


DESLOCAT= (n) 

SL=( 

record # of descriptor 


DESDISPL= (n) 

SP= ( 

byte # of beginning of descriptor 

DSY 

DESID= (n) 

SI= ( 


DESLOCAT= (n) 

SL= ( 



DESDISPL= (n) 

SP= ( 


REC 

RECTYPE=(n) 

RT=( 

record type 


RECSPACE ={n) 

RS=( 

freespace on record (bytes) 


RELOCAT=(n) 

RC=( 

record # 

ALL 

SUBRANGE=(n) 

SR=( 
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3.2 

DCL 


32.7 Model Definition Structure 


1 DEP EXTERNAL, 

2 MOD, 

3 DEFID 
3 NO ZONE 
3 NOSTRATA 
3 NOZONSTA 
3 NWGHCODE 
3 NOHYEARS 
3 NORYEARS 
3 NOXYEARS 
3 NOTRUNCS 
3 NOYVARBL 
3 NOXVARBL 
3 NOYLDDAT 
3 NOMETDAT 
3 NOZ INDEX 
3 NO INVARS 
3 CROPNUMB 
3 MODLNAME 
3 RESERVED 

2 INV, 

3 NUMVARBL 
3 RESERVED 
3 VARBCODE (8) 


FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BINU5,0) , 
FIXED BIN(15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15 ,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN(15,0) , 
FIXED BIN (15,0) , 
FIXED BIN(15,0) , 
CHAR (24) , 
CHAR(244) , 


FIXED BIN (15,0) 
CHAR (2) , 

FIXED BIN (15,0) ; 
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Model Definition Structure, continued 


2 ZON, 

3 LATITUDE ((26) 

3 NUMLEVEL (26) 

3 NUMVARBL(26) 

3 LEVELS (26,8) 

3 VARBC0DE(26,8) 
2 WGH, ' ' 

3 WGHVARBL(8) 

3 NOWEIGHT (8) 

3 WEIGHTS (8,20) 

2 HYR, 

3 NUMLEVEL (6) 

3 NUMYRPRS(8) 

3 LEVELS (6,8) 

3 BEGYEAR(6,8) 

3 ENDYEAR(6,8) 

2 RYR, 

3 NUMLEVEL (6) 

3 NUMYRPRS(8) 

3 LEVELS (6, 8) 

3 BEGYEAR(6,8) 

3 ENDYEAR(6,8) 

2 XYR, 

3 NUMLEVEL (6) 

3 NUMYRPRS(8) 

3 LEVELS (6,8) 

3 BEGYEAR(6,8) 

3 ENDYEAR(6,8) 

2 ZDX 

3 NUMLEVEL (6) 

3 LEVELS (6,8) 

3 UPPERAWC (6) 

3 LOWERAWC (6) 

3 UPPERPCP(6) 

3 LOWERPCP (6) 


FLOAT BIN (21), 
FIXED BIN (15,0) , 
FIXED BIN(15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 

FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FLOAT BIN (21), 

FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 

FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0 , 
FIXED BIN (15,0) , 
FIXED BIN (15,0), 

FIXED BIN (15,0) , 
FIXED BIN (15,0) 
FIXED BIN (15,0), 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 

FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FLOAT BIN (21) , 
FLOAT BIN (21), 
FLOAT BIN (21) , 
FLOAT BIN (21) , 
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Model Definition Structure, continued 


2 TRN, 

3 TRUNCID(16) 

3 TRUNCABV(16) 

3 TRUNNAME(16) 

3 NUMVARBL(16) 

3 VARBLNUM(16,24) 
2 YVR, 

3 VARBLID 
3 VAROPER 
3 VARVC0DE(3) 

3 VARSCODE(3) 

3 VARIK0N(3) 

3 VARL0CAT(3) 

3 VARFKON (3) 

2 XVR, 

3 VARBLID (24) 

3 VAROPER (24) 

3 VARDEV(24) 

3 VARVCODE(24,3) 

3 VARSCODE (24.-3) 

3 VARIKON (24,3) 

3 VAKLOCAT(24,3) 

3 VARFKON(24,3) 

2 YDA, 

3 NUMLEVEL(6) 

3 WHEREGET(6) 

3 USEDYET(6) 

3 NUMVARBL(6) 

3 LEVELS (6, 8) 

3 VARBCODE (6 , 8) 

3 NUMSCODE(6,8) 

3 FIELDSIZ (6,8) 

3 DIGIT(6,8) 

2 MDA, 

3 NUMLEVEL(6) 

3 WHEREGET(6) 

3 USEDYET(6) 

3 NUMVARBL(6) 

3 LEVELS (6, 8) 

3 VARBCODE (6, 8) 

3 NUMSCODE(6,8) 

3 FIELDSIZ (6, 8) 

3 DIGIT(6,8) 


FIXED BIN (15,0) , 
CHAR(4) , 

CHAR (16) , 

FIXED BIN (15,0) , 
FIXED BIN (15,0) , 

FIXED BIN’(15,0), 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FLOAT BIN (21), 

FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FLOAT BIN (21), 

FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0), 

FIXED BIN (15,0) , 
FIXED BIN (15, 0) , 
FIXED BIN (15,0), 
FIXED BIN (15, 0) , 
FIXED BIN (15, 0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0); 
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3.2.32.8 Subfunction MOdel Definition Format 


function applicable section 

DEF DFl , MOD , INV , ZON , WGH , HYR , RYR , XYR , ZDX , TRN , YVR , XVR , 

YDA , MDA , DF Y , DFN , REC 

RPL DF2, MOD, INV, ZON, WGH, HYR, RYR, XYR, ZDX, TRN, YVR, XVR, 

YDA, MDA 

add DF 2 , ZON , INV ,WGH , HYR , RYR , XYR , ZDX , TRN , YVR , XVR , YDA , 

MDA 

DEL DF 2 , INV , ZON , WGH , HYR , RYR , XYR , ZDX , TRN , YVR , XVR , 

YDA, MDA 

LST DF2 .MOD . INV , ZON , WGH ,HYR , RYR .XYR . ZDX . TRN . YVK ,XVR . 


YDA, MDA, ALL 


section 

pa rm/ s ubpa r m 

abv. 

DFl 

DDNAME=(c) 

DD=) 


FILEID=(c) 

ID=( 


PASSWORD=(c) 

PW=( 


NUMSECS=(n) 

NC=( 


SECTIONS=(c) 

SC=( 


COUNTRY=(n) 

C0=( 

DF2 

FILEID=(c) 

ID=( 


PASSWORD=(c) 

PW={ 


NUMSECS=(n) 

NC=( 


SECTIONS=(c) 

SC=( 


DEFID=(n) 

FI=( 


DDNAME=(c) 

DD=( 

MOD 

NOZONE=(n) 

NZ ^ ( 


NOSTRATA =(n) 

NR=( 


NOZONSTA=fn) 

ZS=( 


NWGHCODE=(n) 

N\-7=( 


NOHYEARS=(n) 

HY= ( 


NORYEARS=(n) 

RY= ( 


NOXYEARS=(n) 

XY=( 


NOTRUNCS =(n) 

NU=( 


NOYVARBL=(n) 

NY=( 


NOXVARBL= (n) 

NX=( 


NOYLDDAT= (n) 

DY=( 


NOZINDEX=(n) 

ZX=( 


N0IN^7ARB=(n) 

IB=( 


description 
JCL DD name 

file identification name 
password that can access the 
file 

number of sections used in this 
run (max=17) 
section names 
country ID number 


model definition ID number 


# zones 
#strata 

total # zones plus strata 

# weight codes 

# historical years 

# run years 

# normal years 

# truncations 

# Y-variables 

# X-variables 

# yield data cards 

# 2-index cards 

# raw variable cards 
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Subfunction Model Definition Format, continued 


MOD 

NOMETDAT=(n) 

DM=( 

(cont) 

CROPNUMB=(n) 

CR=( 


MODLNAME=(c) 

MN=( 


RESERVED=:(c) 

RV=( 


DEFID=(n) 

PI=( 


INV 

NVMVARBL»(n) 

NV=( 


RESERVED =(c) 

RV=C 


VARBCODE=(n) 

VC=( 


SUBRANGE=(n) 

SR=( 

ZON/STA 

SUBRANGE=(n) 

SR=( 


NUMLEVEL= (n) 

NL= ( 


LEVELS= (n) 

LV= ( 


LATITUDE^ (f ) 

LA={ 


NUMVARBL= (n) 

NV=( 


VARBCODE= (n) 

VC= ( 

WGH 

WGHVARBL= (n) 

WV=( 


NOWEIGHT= (n) 

WN=( 


WEIGHTS=(n) 

WH=( 


SUBRANGE= (n) 

SK= ( 

HYR/RYR/ 

SUBRANGE=(n) 

CO 

II 

XYR 

M?JMLEVEL= (n ) 

NL= ( 


LEVELS= (n) 

LV= ( 


NUMYRPRS= (n) 

NM= ( 


BEGYEAR= fn) 

BY= ( 


ENDYEAR^ ,n) 

EY=( 

TRN 

SUBRANGE=(n) 

SR=( 


TRUNCID=(n) 

TR=( 


TRUNCABV=(c) 

TA=( 


TRUNNAME= (c) 

TM= ( 


NUMVARBL= 

NV=( 


VARBLNUM= (n) 

VN= ( 


# met data cards 
crop ID number 
model name 

extra space or filler 
model definition number 


# of variables 
reserved space or filler 
variable code number 
subscript range 

subscript range 
number of levels 
level numbers 
latitude of zone/strata 
number of variables 
variable code numbers 

code # of variable to be 
weighted 

# weights 
weights 


number of year pairs (year 
ranges ) 

beginning year of year range 
ending year of year range 


ID number of truncation 
truncation abbreviation 
truncation name 
# of variables 
variable code numbers 
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Subfunction Model Definition Format, continued 


YVR 


XVR 


YDA/MDA 


DFY 


DFN 


SUBRANGE=(n) 

SR=( 


VARBLID=(n) 

VI={ 

ID # of variable 

VAROPER*(n) 

V0={ 

operand of variable 

VARVCODE= (n) 

W=( 

code(s) of variables used to 
calculate variable 

VARSCODE= (n) 

VS= ( 

variable subcode 

VARIKON=(n) 

IK=( 

integer constant 

VARLOCAT= (n) 

VL=( 

where variable is located 

VARPKON= (f ) 

FK= ( 

floating constant 


SUBRAigGE= (n) 

SR=( 


VARBLID=(n) 

VI=( 


VAROPER= (n) 

V0= ( 

variable operand 

VARDEV=(n) 

DV=( 

variable deviation 

VARVCODE= (n ) 

V\^=( 

codes of variables used to 
calculate the variable 

VARSCODE=(n) 

VS=( 

variable subcode 

VARIKON=(n) 

IK=( 

integer constant 

VARLOCAT= (n) 

VL= ( 

variable location 

VARFKON= (f ) 

FK= ( 

floating constant 

SUBRAN GE= (n) 

SR=( 


NUMLEVEL= (n) 

NL= ( 


LEVEL S= (n) 

LV=( 


whereg£:t= (n) 

WG=( 

where to find data 

USEDYET= (n) 

UY=( 

variable used yet? 

NUMVARBL= (n) 

NV= ( 

# variables 

VARBCODE= (n) 

VC= ( 

variable codes 

NUMSCODE= (n) 

N0=( 

# subcodes 

FIELDSIZ= (n) 

FS= ( 

size of each element 

DIGIT= (n) 

DG= ( 

location of decimal point 

DEFID== (n) 

FI= ( 

ID # of this model definition 

DEFLOCAT= (n) 

FL=( 

record # of this model 
definition 


DEFID= (n) 

FI=( 

ID # of model d 'inition 

DEFLOCAT= (n) 

FL=( 

record # of moa-... definition 

NUMLEVEL= (n) 

NI.= ( 


LEVEL S= ; 

LV= ( 
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8ubfunction Model Definition Format^ continued 


ZDX 

NUMLEVEL=(n) 

NL=( 


LEVELS==(n) 

LV=( 


UPPERAWC=(n) 

UW=( 


LOWERAWC=(n) 

LA=( 


UPPERPCP=(n) 

UP=( 


LOWERPCP=(n) 

LP=( 


SUBRANGE=(n) 

SR=( 

REC 

RECTYPE=(n) 

RT=( 


RECSPACE=(n) 

RS=( 


RELOCAT=(n) 

RC=( 

ALL 

SUBRANGE=(n) 

SR=( 


# of levels 
level numbers 

upper available water capacity 
lower available water capacity 
upper precipitation 
lower precipitation 


record type 

freespace on record (bytes) 
record # 
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Data Structure 
NOT APPLICABLE 


c_ ■ 


'"L. 
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1 


3.2.32.10 Subfunction Data Format 

function 

applicable section 

DBF 

DAI, BLK 

,DTA,DAY 

,REC 

RPL 

DAI, BLK 

,FMT,DAD 


ADD 

DAI , BLK 

,FMT,DAD 

, DTA , DAY , REC 

LST 

DA 2, ALL 

,BLK 


section 

parm/subparm 

abv. 

description 

DAI 

DDNAME=(c) 

DD= ( 

JCL DD name 


FILEID= (c) 

ID® ( 

file identification name 


PASSWORD= (c) 

PW= ( 

passw'^rd to access file 


COUNTRY=(n) 

CO® ( 

# o'f country 


DESID=(n) 

SI® ( 

descriptor identification 


NUMSECS= (n) 

NC® ( 

# of sections used 


SECTIONS= (c) 

SC® ( 

section names 

DA2 

DDNAME= (c) 

DD® ( 

JCL DD name 


FILEID= (c) 

ID® ( 

file identification name 


PASSWORD=(c) 

PW= ( 

password to access file 


COUNTRY® (n) 

CO® ( 

# of country 


DESID® (n) 

SI=( 

descriptor identification 


NUMSECS= (n) 

NC® ( 

# of sections used 


SECTIONS® (c) 

SC=( 

section names 


LEVELS® (n) 

LV=( 

level numbers 


NUMLEVEL=(n) 

NL=( 


BLK 

VRBLCODE® (n) 

BC=( 

variable code 


NUMELEM® (n) 

NE® ( 

# subelements 


SUBECODE® (n) 

EC® ( 

subelement code 


FORMAT® (n) 

FM® ( 

format number 


INTLVAL® (n) 

IV® ( 

input value 


SUBRANGE® (n) 

SR® ( 
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Subf unction Data Format, 


continued 


PMT NUMENTRY=(n) NA= ( 


LEADCOLM=(n) LC= ( 

SIZE=(n) SZ=( 

DATATYP= (C ) AT= ( 

SUBRANGEJn) SR= ( 

DAD INMED=(c) IN= ( 

DDNAME=(c) DD=( 

XNRECLEN=(n) RL= ( 

PNDPILE=(c) EP=( 

NUMLEVEL=(n) NL= ( 

LEVELS=(n) LV= ( 

LEWARPY=(n) VP=( 


DTA SUBRANGE= (n ) SR= ( 

NUMLEVEL={n) NL= ( 

LEVELS=(n) LV=( 

DATLOCAT=(n) TL= ( 

DATD ISPLg(n) TP= { 


DAY DATID=(n) TI= ( 

DATDESID=(n) TD=( 

DATBLKSZ=(n) BS=( 

DATBKALC=(n) TB= ( 

DATBKUSE=(n) TU= ( 

DATNOREC=(n) TN=( 

DATPOINT=(n) TP=( 

DATLOCAT=(n) TL= ( 

DATDISPL=(n) TH=( 

DATRBALC= (n) T0= ( 

DATRBUSE=(n) TZ= ( 

DATPBKID=(n) TP=( 

DATNXARR=(n) TX= ( 

SUBRANGE =(n) SR= ( 

REC RECTYPE=(n) RT= ( 

RECSPACE=(n) RS=( 

RECLOCAT=(n) RC*=( 


ALL SUBRANGE=(n) SR= ( 


# of fields on card 
starting card column of field 
size of field 
data type 


input medium 
JCL CD name 
input record length 
end of file delimiter 
nnmber of levels 
level numbers 
level varitxer 


data record # 
data displacement 

directory ID # ot eacn area 
with data on the file 
ID # of descriptor for data in 
this block 

# bytes in data block 
total # blocks allocated 
total # blocks used 

# records used for this 
directory element's data 
subscript- of data location array 
record # for data 

byte # of beginning of data 

# blocks allocated for this 
data on record 

# blocks used for this data on 
record 

first block ID 

pointer to next subscript of 
data location array 


record type 

freespace in record (bytes) 
record number 


3-90 


3.2.33 


Parameter Pile Structures 


3.2 

DCL 


33.1 Section Pile Record 


1 SECTPIL EXTERNAL, 
2 SUBPUN 
2 SECNAME(24) 

2 OPT (5, 24) 

2 ORDER (5, 24) 

2 RESERVED 
2 MAXTIME (5,24) 


Structure 


CHAR(4) , 

CHAR (3) , 

PIXED BIN (15,0) , 
PIXED BIN (15,0) , 
CHAR(248) , 

PIXED BIN (15,0) ; 
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3.2.33.2 


Parameter File Record Structure 


DCL 1 


PARMPIL EXTERNAL 
2 SFUNCTN 
2 SECTION 
2 PARM(24) 

2 PABV(24) 

2 PLEN(24) 

2 MAXNO(24) 

2 MINN0(24) 

2 OPTN(5,24) 

2 TYPE FLAG (32) 

2 RESERVED 


CHAR (4) , 

CHAR(4) , 

CHAR (10) VARYING, 
CHAR(4) , 

FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN (15,0) , 
FIXED BIN(15,0) , 
BIT(l) , 

CHAR(264) ; 


3.2.34 


Error Message File Structure 


DCL 1 


ERREC EXTERNAL 
2 ERROR 
2 RESERVED 
2 MESSAGE 


FIXED BIN (15,0) , 
CHAR (2) , 

CHAR (116) ; 


APPENDIX A 


Parameter/Subparameter Names 


Parameter/ 

Subparameter 

Abv. 

Description 

BASE 

BA 

type of variable 

BEGYEAR 

BY 

beginning year of year range 

BLKLOCAT 

BL 

where variable is located in data block 

BROTHER 

BR 

brother of directory element 

CHILD 

CH 

child of directory element 

CODEABV 

CA 

variable abbreviation 

CODEID 

Cl 

code # for variable 

CODENAfffi 

CN 

variable name 

CODLOCAT 

CL 

position in code array 

COUNTRY 

CO 

country ID number 

CROPNUMB 

CR 

crop ID number 

DATATYP 

AT 

data type 

DATBKALC 

TB 

total # blocks allocated 

DATBKUSE 

TU 

total # blocks used 

DATBLKSZ 

BS 

# bytes in data block 

DATDESID 

TD 

ID # of descriptor for data in this 
block 

DATDISPL 

TH 

byte # of beginning of data 

DATFBKID 

TF 

first block ID 

DATID 

TI 

directory ID # of each area with data 

DATLOCAT 

TL 

record # for data 

DATNOREC 

TN 

# records used for this directory 
element's data 

DATNXARR 

TX 

pointer to next subscript of data 
location array 

DATPOINT 

TP 

subscript of data location array 

DATRBALC 

TO 

# blocks allocated for this data on 
record 

DATRBUSE- - - 

TZ 

# blocks used for this data on record 

DDNAME 

^DD 

JCL DD name 

DEFDISPL 

FP 

byte # of beginning of model definition 

DEFID 

PI 

ID # of each model definition 

DEFLOCAT 

FL 

record # of each model definition 

DESDISPL 

SP 

byte # of beginning of each descriptor 

DESID 

SI 

IS # of descriptor on file 

DESLOCAT 

SL 

record # of each descriptor 

DIGIT 

DG 

location of decimal point 

DIRID 

RI 

ID # of directory 

DIRIDCHR 

FC 

alpha country codes 

DIRIDNUM 

DI 

numeric country codes 
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Parameter/ 

Subparameter 

Abv 

DIRLOCAT 

DL 

DIRNAME 

DN 

DIRNOREC 

DR 

DIRNUMDE 

DE 

DIRTOTDE 

DT 

ELMLOCAT 

EL 

ENDPILE 

EP 

ENDYEAR 

EY 

FIELDSIZ 

FS 

FILEID 

ID 

FORMAT 

FM 

INMED 

IN 

INRECLEN 

RL 

INTLVAL 

IV 

LEADCOLM 

LC 

LEVELS 

LV 

LEWARPY 

VP 

LO^-TERAWC 

LA 

LOWERPCP 

LP 

MODLNAMB 

MN 

NOHYEARS 

HY 

NO INVARS 

IB 

NOMETDAT 

DM 

NORYEARS 

RY 

NOSTRATA 

NR 

NOTRUNCS 

NU 

NOWEIGHT 

WN 

NOXVARBL 

NX 

NOXYEARS 

XY 

NOYLDDAT 

DY 

NOYVARBL 

NY 

NOZ INDEX 

ZX 

NO ZONE 

NZ 

NOZONSTA 

ZS 

NUMBERS 

NB 

NUMDAT 

NT 

NUMDEP 

NP 

NUMDES 

NS 

NUMDIR 

ND 

NUMELEM 

NE 

NUMENTRY 

NA 

NUMLEVEL 

NL 

NUMPASS 

NP 

NDMREC 

PR 


Description 


directory record number 
name of directory level 

# of directory records per country 

# of directory elements per directory record 
total # of directory elements per country 
position in subelement array 

end of file delimiter 
ending year of year range 
size of each element 
file ID name 
format number 
input medium 

input record length 
input value 

starting card column of field 
level numbers 
level verify 

lower available water capacity 
lower precipitation 
model name 

# of history years 

# raw variable cards 

# of met data cards 

# of run years 

# of stratas 

# of truncations 

# of weights 

# of X-variables 

# of normal years 

# of yield data cards 

# of Y-variables 

# of Z-index cards 

# of zones 

total # of zones + strata 

# data blocks on record 

# of directory elements with data 

# of model definitions on file 

# of descriptors on file 

# of countries on file 

# of subelements 

# of fields on input card 

# of levels 

# of passwords 

# of records on file 
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Parameter/ 

Subparameter 

Abv. 

Description 

NUMSCODE 

NO 

# of subcodes 

NUMSECS 

NC 

# of sections 

NUMVARBI 

NV 

# of variables 

NUMYRPRS 

NM 

# of year pairs 

NWGHCODE 

NW 

# of weight codes 

NXTREC 

NQ 

address of next data record 

OUTFIELD 

OF 

output print field size 

PARENT 

PA 

parent of directory element 

PASSWORD 

PW 

password 

RELOCAT 

RC 

record # 

REC SPACE 

RS 

freespace on record (bytes) 

RECTYPE 

RT 

record type 

RESERVED 

RV 

extra space or filler 

SCALE 

SE 

location of decimal point 

SECTIONS 

SC 

sectxon name 

SIZE 

sz 

size of field 

SUBECODE 

EC 

subelernent code 

SUBRANGE 

SR 

range of values in subscript 

TOTCODES 

TC 

# of codes in descriptor 

TOTUNITS 

TS 

# of units in descriptor 

TRUNCABV 

TA 

truncation abbreviation 

TRUNCID 

TR 

ID number of truncation 

TRUNNAME 

TM 

truncation name 

UNITABV 

UA 

variable unit abbreviation 

UNITID 

UI 

variable unit code # 

UNITKAME 

UN 

variable unit name 

UNTLOCAT 

UL 

position in unit array 

UPPERAWC 

UW 

upper available water capacity 

UPPERPCP 

UP 

upper precipitation 

USED YET 

UY 

variable used yet? 

VARBCODE 

VC 

variable code number 

VARBLID 

VI 

ID# of variable 

VARBLNUM 

VN 

variable code number 

VARDEV 

DV 

variable deviation 

VARFKON 

FK 

floating constant 

VARIKON 

IxK 

integer constant 

VARLOCAT 

VL 

variable location 

VAROPER 

VO 

variable operand 

VARS CODE 

VS 

variable subcode 

VARVCODE 

W 

variable variable code 

VRBLCODE 

BC 

variable code 

WEIGHTS 

WH 

weights 

WGHVARBL 

WV 

code # of variable to be weighted 

WHE REGET 

WG 

where to find data 


A- 3 


